3.4.5 客户端对接WHMCS

本文介绍智简魔方 DCIM 系统客户端与 WHMCS 的插件安装、服务器及产品配置和常见连接问题，供需要通过 WHMCS 管理服务器的管理员参考。

前言

客户端 whmcs 插件用于「客户端对接 WHMCS」，实现代理商可使用 whmcs 插件对接，管理服务器开机、关机等

支持 whmcs 版本为「whmcs6.x 」「whmcs7.x」

使用该插件需已搭建web客户端，具体操作请查看

一、客户端 WHMCS 插件下载和安装方法

功能支持

客户端 WHMCS 插件功能支持情况

插件下载和安装

①下载 ：前往【DCIM 后台】-【产品销售】-【客户管理】-【右上角点击下载客户端 whmcs 插件】

客户端 WHMCS 插件下载入口

②安装 ：将下载后的插件【上传至 whmcs 中】，需将【clientipmi 文件】上传至【whmcs 根目录/module/server/中】。

客户端 WHMCS 插件目录结构

二、WHMCS 中的设置

系统通过 whmcs 预留的 server module 原生方式对接至 whmcs，使用 whmcs 原生产品设置和配置选项进行产品的价格定义。

我们使用 whmcs 默认提供的 hash 方式，进行一些接口自定义配置，您可根据教程一步一步完成配置。

添加服务器

【前往 WHMCS】-【系统设置】-【服务器设置】-【添加新的服务器】

WHMCS 添加服务器入口

WHMCS 添加服务器表单 ******* 必填字段：**

NAME（名称）： 任意，可填写 clientipmi
Hostname （主机名）： 填写访问 web 客户端的域名或 ip 地址
Ip（IP 地址）： 填写访问 web 客户端的域名或 ip 地址

WHMCS 服务器地址配置项

Type（类型）： 选择 clientipmi
Username（用户名）：web 客户端登录的用户名（账号）
Password（密码）：web 客户端登录的密码
勾选 SSL： 端口默认为 443，如有变更 web 客户端访问端口，请填写 web 客户端端口
Hash（访问散列值） 建议配置如下：点击这里查看参数说明

<flowchart>on</flowchart>
<kvm>on</kvm>
<resetbmc>on</resetbmc>
<kvmadmin>on</kvmadmin>
<resetbmcadmin>on</resetbmcadmin>
<reinstall>on</reinstall>
<reinstalladmin>on</reinstalladmin>
<reinstalltimes>99</reinstalltimes>
<adminoutip>on</adminoutip>
<post_emailorid>userid</post_emailorid>
<changehostname>ip</changehostname>
<reboot>on</reboot>
<rebootadmin>on</rebootadmin>
<off>on</off>
<offadmin>on</offadmin>
<on>on</on>
<onadmin>on</onadmin>
<ikvm>on</ikvm>
<ikvmadmin>on</ikvmadmin>
<vnc>on</vnc>
<vncadmin>on</vncadmin>
<idcimadmin>on</idcimadmin>
<rescue>on</rescue>
<rescueadmin>on</rescueadmin>
<crackadmin>on</crackadmin>
<crack>on</crack>
<customport>on</customport>
<custompartition>on</custompartition>

WHMCS 服务器 Hash 配置项

添加服务器分组

【前往 WHMCS】-【系统设置】-【服务器设置】-【创建新的分组】

WHMCS 创建服务器分组入口

WHMCS 服务器分组配置表单

分配服务器至分组

将服务器分配至 WHMCS 分组

添加产品

前往【系统设置】-【产品/服务】-【产品/服务】-【新增产品】

WHMCS 新增产品入口

产品类型： 独服/VPS
产品名称： 服务器产品型号 1
模块设置： 模块名称-clientipmi
服务器组： clientipmi
类型： 服务器租用

WHMCS 产品基本信息配置

WHMCS 产品模块设置

三、WHMCS 前后台管理

产品对接 Web 客户端实现开机、关机和重装管理

完成以上配置后，我们即可实现对接管理，为客户添加产品

WHMCS 后台为客户添加产品

WHMCS 客户产品详情

在服务器 ID 处填写该服务器在 web 客户端的 ID,即可操作功能。

WHMCS 产品服务器 ID 配置

WHMCS 后台服务器管理功能

会员中心管理功能

同时，客户可在会员中心前台进行管理。

关于允许客户使用的功能控制，请参考 4.1 ipmi插件配置参数说明

WHMCS 会员中心服务器管理功能

四、问题说明

插件配置参数说明

以下为一组完整、可复制的参数示例：

<flowchart>on</flowchart>
<kvm>on</kvm>
<resetbmc>on</resetbmc>
<kvmadmin>on</kvmadmin>
<resetbmcadmin>on</resetbmcadmin>
<reinstall>off</reinstall>
<reinstalladmin>on</reinstalladmin>
<reinstalltimes>3</reinstalltimes>
<adminoutip>on</adminoutip>
<post_emailorid>userid</post_emailorid>
<changehostname>ip</changehostname>
<reboot>on</reboot>
<rebootadmin>off</rebootadmin>
<off>on</off>
<offadmin>on</offadmin>
<on>on</on>
<onadmin>on</onadmin>
<ikvm>on</ikvm>
<ikvmadmin>on</ikvmadmin>
<vnc>on</vnc>
<vncadmin>on</vncadmin>
<idcimadmin>on</idcimadmin>
<rescue>off</rescue>
<rescueadmin>on</rescueadmin>
<crackadmin>on</crackadmin>
<crack>on</crack>
<customport>on</customport>
<custompartition>on</custompartition>

flowchart： 是否开启流量图输出，on 开启，off 关闭。
kvm： 是否开启 KVM 控制按钮输出，on 开启，off 关闭。
resetbmc： 是否输出重置 BMC 按钮，on 开启，off 关闭。
kvmadmin： 管理员界面是否输出 KVM 控制按钮，on 开启，off 关闭。
resetbmcadmin： 管理员界面是否输出重置 BMC 按钮，默认开启。
reinstall / reinstalladmin： 前台和管理后台是否输出重装按钮。
reinstalltimes： 每周允许重装的次数。
adminoutip： 开启后输出后台 IP 控制面板。
post_emailorid： email 传递邮箱，userid 传递 WHMCS 用户 ID。
changehostname： hostname 使用机器名称，ip 使用主 IP，hostnameip 使用“机器名称-主 IP”。
reboot / rebootadmin： 前台和管理后台是否输出重启按钮。
off / offadmin： 前台和管理后台是否输出关机按钮。
on / onadmin： 前台和管理后台是否输出开机按钮。
ikvm / ikvmadmin： 前台和管理后台是否输出 iKVM 按钮。
vnc / vncadmin： 前台和管理后台是否输出 VNC 按钮。
idcimadmin： 管理员界面是否输出快捷跳转服务器管理系统按钮。
rescue / rescueadmin： 前台和管理后台是否输出救援系统按钮。
crack / crackadmin： 前台和管理后台是否输出破解密码按钮。
customport： 前台重装时是否允许自定义端口。
custompartition： 前台重装时是否允许自定义分区。

changehostname 使用“机器名称-主 IP”时的示例：

w20101-10.10.0.1

账号、密码错误

检查web客户端登录信息和WHMCS的服务器设置的用户名和密码是否一致

连接端口错误

检查SSL端口是否填写正确

无法连接

检查WHMCS服务器设置中的主机名及IP是否填写正确

本页目录